home *** CD-ROM | disk | FTP | other *** search
/ Aminet 25 / Aminet 25 (1998)(GTI - Schatztruhe)[!][Jun 1998].iso / Aminet / util / libs / graphics3d.readme < prev    next >
Encoding:
Text File  |  1998-05-05  |  10.4 KB  |  226 lines
  1. Short:    3D graphics shared library V10.13(beta)
  2. Author:   p.biancalani@mbox.match.it
  3. Uploader: p.biancalani@mbox.match.it
  4. Type:     util/libs
  5.  
  6. Version        12.20
  7.  
  8. --- English ----
  9. First sorry for my bad English but I don't know it very well.
  10. This is a simple but complete graphic 3D library that use for visualization
  11. only the system library .
  12. Main feature include :
  13.  
  14.    - Visualization of object in systems windows with single buffering.
  15.    - Support of polygons with one, two, tree and four vertex.
  16.    - Use of only fix point value than the math coprocessor is not
  17.      necessary, and is relatively fast on machines us A1200 base too.
  18.    - Implementation of visualization in Wire Frame ,Solid shading and
  19.      Flat shading all simultaneous too and with light source freely 
  20.      placeable .
  21.  
  22. Is tested on (for now): 
  23.    A4000/40 with S.O. 3.0
  24.    A1200 base with S.O 3.0
  25.    A2000 with 060 and S.O. 3.1
  26.  
  27. But now it is support a 68000 also (on a 68040 run) and I think that 
  28. S.O. 2.0 can be sufficent to run, (but I don't tested).
  29.  
  30. The rendering engine is entirely based on blitzbasic graphic3D engine V0.9
  31. by Maciej R.Gorny .
  32.  
  33. The library appears to be solid at my test but is only a beta version and
  34. if anyone want to be a betatester can send to me an E-Mail is welcome.   
  35.  
  36. THIS LIBRARY IS A COPYRIGHT OF THE AUTHOR PATRIZIO BIANCALANI AND IS A 
  37. FREEWARE SOFTWARE THAN FREELY USABLE AND DISTRIBUITE BUT WITH ALL FILE OF 
  38. ORIGINAL ARCHIVE AND NOT FOR RESALE OR IT CAN'T BE SOLD, THAN I PROVIDE 
  39. ABSOLUTELY NO WARRANTY FOR THIS SOFTWARE.
  40. IF YOU WANT MODIFY THE ORIGINAL SOURCES TELL ME THIS THAN ,IF IT IS OK, 
  41. I CAN UPDATE ALL ORIGINAL ARCHIVE.
  42. It is very pleasant if you send me an e-mail if you use it.
  43.  
  44. I have included an example write in E (and full commented) and all the source
  45. in C of this library .The executable is 3dlib and it must be in the same
  46. directory of #?.plg files. 
  47.  
  48. The documentation is now all traslate in English too, but this is very dirty
  49. than sorry and if you found thinks that are not clear send me a e-mail and 
  50. I try to correct it. 
  51.  
  52. The file graphics3d_000.library is the library for CPU from 68000.
  53. The file graphics3d_020.library is the library for CPU from 68020.
  54. You must rename the correct library to graphics3d.library before use it.
  55.  
  56. Thanks to:
  57.    Maciej R.Gorny for the original routin of engine 3D.
  58.    Alessandro Franchi for beta testing on A1200.
  59.    VolKer Barthelmann author of VBCC the C compiler used by me to write the
  60.    library.
  61.    Andreas Kleinert author of the optimal startupcode for write shared
  62.    library. 
  63.    The authors of Tornado3D for the suggetions to implemented the single
  64.    buffering in a window. 
  65.    All ones that have write an e-mail to me.
  66.  
  67. I'am Patrizio Biancalani from Prato (Italy) and the my E-Mail for
  68. suggestions and signaling is :p.biancalani@mbox.match.it
  69.  
  70. Support site :www.amigaworld.com/support/graphics3dlib/welcome.html
  71.  
  72. --- Italiano ---
  73.  
  74. Questa e' una semplice ma completa libreria grafica 3D che si appoggia
  75. interamente sulle librerie di sistema per la visualizzazione.
  76. Le caratteristiche principali sono:
  77.    
  78.    - Visualizzazione oggetti nelle finestre con single buffering.
  79.    - Supporto di poligoni a uno, due, tre e quattro vertici. 
  80.    - Usa valori solo in fix point quindi il coprocessore non serve
  81.      ed e' relativamente veloce anche su macchine come il A1200 base.
  82.    - Implementa la visualizzazione in Wire Frame ,Solid shading e
  83.      Flat shading anche tutti contemporaneamente e con la fonte di 
  84.      luce posizionabile a piacere.
  85.  
  86. E' stata testata su(per ora):
  87.    A4000/40 con S.O. 3.0
  88.    A1200 base con S.O 3.0
  89.  
  90. Ma adesso e' supportato anche il 68000 (gira su un 68040) e penso che sia
  91. sufficente un S.0 dal 2.0 in poi. 
  92.  
  93. Il motore di rendering e' interamente basato sul blitzbasic 3d graphics
  94. engine V0.9 di Maciej R.Gorny .
  95.  
  96. La libreria si e' dimostrata alle mie prove abbastanza solida, pero' e'
  97. sempre una beta e se c'e' qualcuno disposto a farmi da betatester mi mandi
  98. subito un E-Mail sara' il benvenuto. 
  99.  
  100. QUESTA LIBRERIA E' UN COPYRIGHT DELL'AUTORE PATRIZIO BIANCALANI ED E' UN
  101. FREEWARE SOFTWARE QUINDI LIBERAMENTE DISTRIBUIBILE MA CON TUTTI I FILE
  102. DELL'ARCHIVIO ORIGINALE E NON PER FINI DI LUCRO, IO NON FORNISCO 
  103. ASSOLUTAMENTE ALCUNA GARANZIA SU QUESTO SOFTWARE.
  104. SE VOLETE MODIFICARE I SORGENTI ORIGINALI COMUNICATEMELO, SE E' ACCETTABILE
  105. IO AGGIORNERO' L'ARCHIVIO ORIGINALE.
  106. E' molto gradita la ricezione di un e-mail in caso di uso della libreria. 
  107.  
  108. Ho incluso anche un esempio di uso scritto in E e i sorgenti in C della
  109. libreria.L'eseguibile si chiama 3dlib e deve essere nella stessa directory
  110. dei file #?.plg .
  111.  
  112. La documentazione ora e' stata interamente tradotta anche in Inglese anche
  113. se in modo orribile, se qualcuno volesse farmi notare errori o meglio 
  114. correggerli e' veramente benvenuto.
  115.  
  116. Il file graphics3d_000.library e' per le CPU dal 68000.
  117. Il file graphics3d_020.library e' per le CPU dal 68020.
  118. Occorre rinominare la corretta libreria in graphics3d.library prima di
  119. usarla.
  120.  
  121. Si ringrazia :
  122.    Maciej R.Gorny per le routin del motore 3D.
  123.    Alessandro Franchi per il parziale beta testing su A1200.
  124.    VolKer Barthelmann autore del compilatore C VBCC da me usato per
  125.    la stesura della libreria.
  126.    Andreas Kleinert autore dell'ottimo startupcode per le shared
  127.    library. 
  128.    Gli autori di Tornado3D per il suggerimento su come implementare 
  129.    il single buffering in una finestra.
  130.    Tutti quelli che mi hanno scritto.
  131.  
  132. Io sono Patrizio Biancalani residente a Prato Italy e il mio E-Mail per
  133. suggerimenti e segnalazioni e': p.biancalani@mbox.match.it
  134.  
  135. Sito di supporto :www.amigaworld.com/support/graphics3dlib/welcome.html
  136.  
  137.  
  138. ============================= Archive contents =============================
  139.  
  140. Original  Packed Ratio    Date     Time    Name
  141. -------- ------- ----- --------- --------  -------------
  142.    21712    8248 62.0% 21-Apr-98 19:58:08  3Dlib
  143.      351     181 48.4% 04-Nov-97 01:17:34  barrier.plg
  144.      590     235 60.1% 04-Nov-97 01:17:34  cube.plg
  145.     1552     597 61.5% 21-Apr-98 19:55:12 +graphics3D.fd
  146.     1837     932 49.2% 21-Apr-98 19:55:12 +graphics3D.i
  147.     1552     597 61.5% 21-Apr-98 19:55:12 +graphics3D.fd
  148.     9556    3136 67.1% 21-Apr-98 19:55:12 +graphics3D.h
  149.     2124     815 61.6% 21-Apr-98 19:58:02 +graphics3D_stub.lib
  150.      834     379 54.5% 21-Apr-98 19:55:12 +graphics3Dbase.h
  151.      631     305 51.6% 21-Apr-98 19:58:04 +graphics3D.m
  152.      438     248 43.3% 21-Apr-98 19:58:06 +graphics3D_lib.m
  153.    13637    3893 71.4% 21-Apr-98 20:16:28 +graphics3D.h
  154.     9556    3136 67.1% 13-Apr-98 12:09:46 +graphics3D.h.doc
  155.     1014     573 43.4% 19-Apr-98 19:52:08 +graphics3d.history
  156.     1394    1083 22.3% 26-Feb-98 23:35:00 +graphics3d.history.info
  157.     4459    1780 60.0% 19-Apr-98 19:36:54 +graphics3d.notes
  158.     1394    1084 22.2% 27-Feb-98 23:39:42 +graphics3d.notes.info
  159.    41553    9710 76.6% 21-Apr-98 20:19:36 +graphics3d_E.doc
  160.     1154     757 34.4% 27-Feb-98 23:35:52 +graphics3d_E.doc.info
  161.    55750   10629 80.9% 21-Apr-98 20:20:38 +graphics3D_E.guide
  162.     1611     755 53.1% 26-Feb-98 23:31:42 +graphics3d_E.guide.info
  163.    43434   10047 76.8% 19-Apr-98 19:09:10 +graphics3d_I.doc
  164.     1154     757 34.4% 27-Feb-98 23:35:44 +graphics3d_I.doc.info
  165.    57305   11034 80.7% 21-Apr-98 20:16:34 +graphics3d_I.guide
  166.     1611     755 53.1% 26-Feb-98 23:31:42 +graphics3d_I.guide.info
  167.     5656    2647 53.2% 19-Apr-98 19:44:14  graphics3d.readme
  168.    35232   15282 56.6% 19-Apr-98 20:13:06  graphics3D_000.library
  169.    25964   13588 47.6% 19-Apr-98 20:01:44  graphics3d_020.library
  170.      130      71 45.3% 04-Nov-97 01:17:34  ground.plg
  171.      186     101 45.6% 04-Nov-97 01:17:34  lettera.plg
  172.      773     402 47.9% 04-Nov-97 01:17:34  letterT.plg
  173.      140      93 33.5% 04-Nov-97 01:17:34  missile.plg
  174.      146     106 27.3% 04-Nov-97 01:17:34  plane.plg
  175.      365     175 52.0% 04-Nov-97 01:17:34  pylons.plg
  176.      944     418 55.7% 04-Nov-97 01:17:36  pyramid.plg
  177.      525     165 68.5% 28-Mar-98 12:27:50  rad.plg
  178.      267     155 41.9% 04-Nov-97 01:17:34  rock.plg
  179.     1146     394 65.6% 04-Nov-97 01:17:36  sfer.plg
  180.    30984    8128 73.7% 07-Dec-97 11:40:02  sfera.plg
  181.    30984    8132 73.7% 04-Nov-97 01:17:36  sfera1.plg
  182.    30984    8132 73.7% 04-Nov-97 01:17:34  sfera2.plg
  183.     9891    2576 73.9% 04-Nov-97 01:17:36  sfera_old.plg
  184.      481     221 54.0% 04-Nov-97 01:17:34  slider.plg
  185.     2330     661 71.6% 21-Apr-98 19:55:06 +3dlib-020.asm
  186.      526     401 23.7% 21-Apr-98 19:55:06 +3dlib-020.m
  187.    10358    3536 65.8% 13-Apr-98 12:09:50 +3dlib.h
  188.     6632    2479 62.6% 21-Apr-98 19:57:46 +3dlibdemo.e
  189.     1125     603 46.4% 13-Apr-98 12:09:50 +3dlibh.h
  190.      129     102 20.9% 28-Jan-98 21:23:36 +compila
  191.    16336    4355 73.3% 28-Jan-98 21:27:22 +gad.h
  192.     2389     863 63.8% 13-Apr-97 09:58:52 +gen.h
  193.      631     305 51.6% 21-Apr-98 19:58:04 +graphics3D.m
  194.      438     248 43.3% 21-Apr-98 19:58:06 +graphics3D_lib.m
  195.      593     317 46.5% 13-Apr-98 12:09:48 +debuglib.c
  196.      269     152 43.4% 13-Apr-98 12:09:48 +debuglib.h
  197.     1552     597 61.5% 21-Apr-98 19:55:12 +graphics3D.fd
  198.     9556    3136 67.1% 13-Apr-98 12:09:46 +graphics3D.h
  199.     1837     932 49.2% 13-Apr-98 12:09:46 +graphics3D.i
  200.     4793    1409 70.6% 13-Apr-98 12:09:54 +graphics3D.make
  201.    13399    4003 70.1% 13-Apr-98 12:09:48 +graphics3D2d.c
  202.     1015     333 67.1% 13-Apr-98 12:09:50 +graphics3D2d.h
  203.      969     340 64.9% 13-Apr-98 12:09:48 +graphics3D2d_proto.h
  204.      834     379 54.5% 13-Apr-98 12:09:50 +graphics3Dbase.h
  205.      791     367 53.6% 13-Apr-98 12:09:50 +graphics3Dc.h
  206.    44039   10912 75.2% 13-Apr-98 12:09:48 +graphics3Df.c
  207.     4168     862 79.3% 13-Apr-98 12:09:48 +graphics3Df.h
  208.    30455    8418 72.3% 13-Apr-98 12:09:48 +graphics3Df_i.c
  209.     9130    2224 75.6% 13-Apr-98 12:09:50 +graphics3Df_i2.c
  210.     3840     849 77.8% 21-Apr-98 19:55:12 +graphics3Df_proto.h
  211.    12033    2702 77.5% 13-Apr-98 12:09:50 +graphics3Df_t.c
  212.     6637    2111 68.1% 19-Apr-98 19:40:18 +graphics3Dli.c
  213.      926     326 64.7% 03-Apr-98 10:44:08 +graphics3dm.c
  214.     2601     594 77.1% 13-Apr-98 12:09:50 +graphics3dm.s
  215.      607     352 42.0% 13-Apr-98 12:09:50 +graphics3Dm68k.c
  216.     8386    2175 74.0% 13-Apr-98 12:09:46 +graphics3Dsu.c
  217.      431     187 56.6% 04-Nov-97 01:17:34  station.plg
  218.     9891    2576 73.9% 04-Nov-97 01:17:36  tall_piramyd.plg
  219.      375     151 59.7% 04-Nov-97 01:17:36  tall_pyramid.plg
  220.      538     233 56.6% 04-Nov-97 01:17:34  tallon.plg
  221.      508     249 50.9% 04-Nov-97 01:17:34  tele.plg
  222.    13003    3401 73.8% 21-Feb-98 13:17:24  test.plg
  223.      324     140 56.7% 04-Nov-97 01:17:34  tower.plg
  224. -------- ------- ----- --------- --------
  225.   675395  196432 70.9% 22-Apr-98 02:04:38   82 files
  226.